- 3 minutes to read

Release Notes

Installing the Nodinite Log4Net Appender

Unlock the full potential of your .NET applications with the Nodinite Log4Net Appender. This guide provides a clear, step-by-step process to help you quickly install, configure, and start leveraging robust, centralized logging and monitoring with Nodinite. Whether you're a systems integration expert or evaluating solutions for your business, you'll discover how easy it is to get started and why Nodinite stands out.

With this guide, you will:

✅Rapidly enable advanced logging and monitoring for your .NET applications
✅Ensure seamless integration with the Nodinite Log API
✅Benefit from centralized, scalable, and secure log management
✅Avoid common pitfalls with clear, actionable steps

This guide teaches you how to use the Nodinite Log4Net Appender and perform basic configuration to get started with logging and monitoring.
Either follow the instructions here or explore the Implement in a new .NET application user guide for a fresh setup.

Before you begin

Make sure you meet all prerequisites. This ensures a smooth installation and optimal performance.

Step 1: Copy required binaries

Copy the following essential files to your application's bin folder:

  • Nodinite.LogAgent.Log4NetAppender.dll
  • IBSS.Libraries.Contracts.LogRestApi.dll

Depending on your version, you may also need these dependencies (as of release 5.0.2):

  • log4net.2.0.15
  • Microsoft.NETCore.Platforms.2.0.0
  • Newtonsoft.Json.13.0.3
  • System.ComponentModel.Annotations.5.0.0
  • System.Configuration.ConfigurationManager.4.5.0
  • System.Net.Http.Json.7.0.1
  • System.Security.AccessControl.4.5.0
  • System.Security.Cryptography.ProtectedData.4.5.0
  • System.Security.Permissions.4.5.0
  • System.Security.Principal.Windows.4.5.0
  • System.Text.Encodings.Web.7.0.0
  • System.Text.Json.7.0.2

When you add the package reference to your project, you automatically get the correct versions. Regularly update your binaries to benefit from the latest improvements and security updates.

Step 2: Manage the configuration file

Open or create the log4net.config file using Notepad++ or your preferred editor, then add the following section:

<log4net>
  <appender name="Log4NetAppender" type="Nodinite.LogAgent.Log4NetAppender.NodiniteLog4NetAppender,Nodinite.LogAgent.Log4NetAppender">
    <!-- Custom Parameters -->
    <OriginalMessageType value="Nodinite.LogAgent.Log4NetAppender/2.0#DefaultMessageType" />
    <MessageTypeExtractFromBody value="false" />
    <LogAgentID value="101"/>
    <EventNumber value="0"/>
    <EndPointName value="Log4Net Unit Test"/>
    <EndPointUri value="VS.local.log4net.test"/>
    <!--<LogText value =""/>-->
    <!--<LogStatusId value ="255"/>-->
    <ProcessingUser value="Administrator"/>
    <ModuleType value="unit test"/>
    <ProcessName value="unit test"/>
    <ProcessingMachineName value="DEV"/>
    <ProcessingModuleType value="unit test"/>
    <ProcessingModuleName value="VS"/>
    <LogApiServiceURI value="http://localhost/Nodinite/Dev/logapi"/>
    <ApplicationInterchangeId value="{99106FF5-C7BB-4244-9EB7-F99040190F32}"/>
    <LocalInterchangeId value="{E4CDDF18-9925-4A79-8E9F-71BC0D4C5172}"/>
    <ServiceInstanceActivityId value="{E4CDDF18-9925-4A79-8E9F-71BC0D4C5173}"/>
  </appender>
  <root>
    <level value="DEBUG"/>
    <appender-ref ref="Log4NetAppender"/>
  </root>
</log4net>

The XML elements above enable Nodinite to generate rich JSON Log Event.

Tip: Ensure the LogApiServiceURI points to your Nodinite Log API instance for seamless integration.

Support

If you encounter issues during installation, contact our Support.

Note

Additional troubleshooting information may be available in the Windows Event Logs.

Frequently asked questions

Find more solutions and answers in the Troubleshooting user guide for the Nodinite Log4Net Appender.

Next Step